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Hari 1 : Instalasi dan Konfigurasi Laravel 

Laravel sangat mudah dikonfigurasi untuk mengembangkan sebuah aplikasi. Pada bagian ini akan saya 
jelaskan apa saja yang hams dipersiapkan untuk memulai menggunakan framework Laravel. Untuk memu- 
dahkan pemahaman, saya tidak akan menjelaskan beberapa istilah secara rinci. 

Text Editor 

Selama mengembangkan aplikasi di buku ini, saya menggunakan teks editor Sublime Text 3 1 dengan plugin 
Laravel Blade Highlighter 2 untuk menampilkan syntax highlighting blade dan Emmet 3 untuk mempercepat 
mengetik HTML. Jika Anda lebih menyukai sebuah IDE, saya sarankan menggunakan PHPStorm 4 atau 
AksilDE 5 karya om Luri Darmawan 6 , seorang anak bangsa yang merupakan member yang disegani di grup 
PHP Indonesia 7 . 

Jika Anda akan menggunakan Sublime Text, pastikan untuk menginstal package control agar Anda dapat men- 
ginstal package. Panduan cara menginstal package control dapat anda baca di https://sublime.wbond.net/installation 8 . 

Untuk menginstal package di Sublime Text dengan package control dapat dibaca di https://sublime.wbond.net/docs/usage 9 . 

Kebutuhan Sistem 

Laravel mendukung penggunaan web server apache dan ngix. Pada buku ini, saya menggunakan web server 
Apache. Pastikan PHP yang Anda gunakan sudah versi 5.4 keatas dengan ekstensi MCrypt. Saya sendiri 
menggunakan MAMP 10 untuk OSX, jika Anda pengguna windows bisa menggunakan XAMPP 11 . 

Untuk database Laravel dapat menggunakan database MySQL, PostgreSQL, SQLServer atau SQLite. 

Homestead 



Jika Anda belum menggunakan Homestead, sebaiknya segera belajar menggunakannnya. Homestead meru- 
pakan package Vagrant yang akan memudahkan Anda membuat virtual machine untuk development aplikasi 
PHP. Dengan menggunakan homestead, Anda tidak perlu repot-repot mengurusi error karena ada extensi 
PHP yang belum aktif dan error karena masalah web server lainnya. 



1 www. sublimetext . com 

2 http://github.com/Medalink/laravel- blade 

3 http://emmet.io 

4 http ://■ www. j etb rains . com/php storm 

5 http://aksiide.com 

6 https://www.facebook.com/luridarmawan 

7 https://www.facebook.com/groups/35688476100 

8 https://sublime.wbond.net/installation 

9 https://sublime.wbond.net/ docs/usage 

10 www.mamp.info 

“www.apachefriends.org 
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Beberapa aplikasi yang sudah disediakan oleh Homestead : 

• Ubuntu 14.04 

• PHP5.5 

• Nginx 

• MySQL 

• Postgres 

• Node (dengan Bower, Grunt, dan Gulp) 

• Redis 

• Memcached 

• Beanstalkd 

• Laravel Envoy 

• Fabric + HipChat Extension 

Untuk menggunakan homestead Anda perlu menginstall Virtual Box 12 dan Vagrant 13 . Silahkan diinstall dua 
aplikasi tersebut terlebih dahulu. 

Selanjutnya ikuti langkah berikut : 

1. Install vagrant box untuk homestead dengan perintah 



1 $ vagrant box add laravel/homestead 

Perintah ini akan mendowload box atau Virtual Machine ubuntu yang sudah terkonfigurasi dari Internet. 
Tunggulah hingga prosesnya selesai. 

1. Setelah berhasil mendownload box homestead, kini Anda perlu melakukan clone repository github dari 
homestead. Pastikan Anda sudah menginstall Git di komputer Anda. Jalankan perintah ini di folder 
yang Anda inginkan bisa di folder yang Anda inginkan. 



1 $ git clone https: //github . com/ laravel /homestead . git Homestead 

1. Agar kita dapat mengakses homestead dengan SSH, kita perlu memberitahu homestead lokasi file ssh 
kita. Pada folder homestead yang baru di clone, buka file Homestead .yaml. Ubah isian authorize dan 
keys dengan lokasi file id_rsa Anda. Biasanya settingan default sudah sesuai dengan lokasi id_rsa di 
komputer kita. 

2. Homestead bekerja dengan cara memetakan folder di host OS dengan guest OS (virtual machine). 
Dengan pemetaan ini, kita dapat coding di host OS dan aplikasi kita tetap dijalankan dari guest OS. 

12 https://www.virtualbox.org/wiki/Downloads 
1 3 http :// www. vagrantup . com/downloads .html 
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Cek kembali file Homestead .yaml, terlihat ada isian folders dengan isian default map: ~/Code dan to: 

/home/vagrant/Code. Pada isian ini dijelaskan folder ~/Code di host OS akan dipetakan ke folder /home/vagrant/Code 
di guest OS. Silahkan sesuaikan isian map dengan lokasi dimana Anda akan menempatkan project Laravel. 

Sedikit gambaran untuk pengguna Xamp, karena biasanya project web disimpan di folder C : \xampp\htdocs 
maka Anda cukup mengubah map : ^/Code menjadi map : C : \xampp\htdocs. 

1. Ini bagian yang paling menarik. Setiap web yang berjalan dengan homestead, akan kita akses dengan 
URL yang kita inginkan. Cek kembali isian Homestead .yaml, terdapat isian sites dengan isian default 
map: homestead . app dan to /home/vagrant/Code/Laravel/publ ic. 

Maksud dari isian ini adalah ketika di host OS kita mengakses http : //homestead . app : 8000 maka 
homestead akan melayani web dari folder /home/vagrant/Code/Laravel/publ ic. Karena folder /home/vagrant/Code 
merupakan map dari ~/ Sites, maka URL ini sebenarnya mengambil file dari ~/Si tes/Laravel/publ ic. 

Jadi, jika Anda membuat aplikasi Laravel di ^/Sites/webapp dan ingin mengaksesnya dengan URL 
http://webapp.site: 8000. Langkah yang Anda lakukan adalah menambahkan isian di sites ini. 

Dengan isian map : webapp.site dan to: /home/vagrant/Code/webapp/publ ic. 

2. Agar URL yang kita buat di tahap 4 dapat diakses, kita perlu menambah isian host file. Di *nix Anda da- 

pat mengubah nya di /etc/hosts, sedangkan di Windows ada die : \windows\system32\dr i vers\etc\hosts. 
Tambahkan setiap hostname yang kita buat dan petakan ke 127 . 0 . 0 . 1 . Misalnya: 



webapp.site 127.0.0.1 




Catatan untuk Windows 

Terkadang file hosts ini tidak bisa langsung disimpan di tempatnya. Solusinya, simpan terlebih 
dahulu file ini di desktop, lantas replace file aslinya. 



1. Terakhir, untuk menjalankan homestead, masuk ke folder homestead dan jalankan perintah: 



$ vagrant up 



Dengan homestead, Anda tidak akan direpotkan dengan konfigurasi sistem yang berbeda tiap anggota tim. 

Untuk mengetahui, password default dan konfigurasi lebih lanjut tentang homestead, kunjungi http://laravel.com/docs/homesti 



14 http://laravel.com/docs/homestead 
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Composer 

Untuk menginstall laravel kita akan menggunakan composer. Composer adalah aplikasi yang digunakan 
untuk mengatur package-package dalam mengembangkan sebuah web dengan PHP. Jika dulu, mungkin Anda 
mengenal yang namanya PEAR 15 , composer tuh mirip-mirip PEAR lah. 

Anggaplah kita belum kenal dengan PEAR/Composer. Jika kita akan mengembangkan sebuah aplikasi web 
dan membutuhkan library untuk user management misalnya ‘UserAuth’ maka kita akan download dari 
webnya, letakkan di folder tertentu (misalnya library), kemudian me-load dengan require atau include pada 
class yang kita butuhkan. 

Setidaknya ada beberapa masalah dari solusi ini: 

• Bagaimana jika web kita membutuhkan tidak hanya satu library, tapi 40 library? Mau download satu- 
persatu? 

• Bagaimana jika library UserAuth bergantung dengan library lain? misalnya SessionManager dan 
SessionManager juga bergantung kepada library Session. Dan seterusnya, dan seterusnya.. 

Pada Laravel, kita akan menggunakan composer tidak hanya untuk menginstall library, tapi framework 
Laravel itu sendiri diinstall menggunakan composer. 

Untuk memahami composer lebih lanjut, Anda dapat mengunjungi dokumentasi resmi composer 16 . 

Install Composer 

Instalasi composer agak berbeda untuk OS *nix (Linux, OSX, dll) dan Windows, saya jelaskan masing-masing: 

Windows 

Cukup download composer-setup.exe 17 dan jalankan file instalasi. 

*nix 

Jalankan terminal dan masukkan perintah berikut: 



1 $ curl -sS https://getcomposer.org/installer | php 

2 $ sudo mv composer . phar /usr/local/bin/composer 

15 pear.php.net 

I6 https://getcomposer.org/doc/00-intro.md 
17 https://getcomposer.org/Composer- Setup.exe 
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Penggunaan Composer 



Secara default, composer akan menggunakan package yang teregister di packagist.org 18 . Tentunya, kita juga 
dapat menyiapkan repositori package private menggunakan satis 19 . 



© O O ^ Packagist 

<- C (3 https://packagist.org 



☆ = 



Create 



Packagist 

The PHP package archivist. 



Submit Package 



Packagist is the main Composer repository. It aggregates all sorts of PHP packages that are installable with Composer. 
Browse packages or submit your own. 



[ Search packages... 



Getting Started 

Define Your Dependencies 

Put a file named composer.json at the root of your project, 
containing your project dependencies: 

{ 

"require”: { 

"vendor/package": "1.3.2", 

"vendor /package2 " : " 1 . * " , 

" vendor /package3" : ">=2.0.3" 

> 

> 

Install Composer In Your Project 

Run this in your command line: 

curl -s http://getcomposer.org/installer | php 



Publishing Packages 

Define Your Package 

Put a file named composer.json at the root of your package, 
containing this information: 

{ 

* name " : "your-vendor-name/package-name * , 
"description" : "A short description of 
what your package does", 

"require" : { 

"php": ">=5.3.0", 

" another-vendor /package " : " 1 . * " 

> 

> 

This is the strictly minimal information you have to give. 

For more details about package naming and the fields you can use 
to document your package better, see the about page. 



Packagist.org 



Composer menggunakan file dengan format JSON 20 . JSON merupakan format standar untuk menyimpan data 
name=^> value yang sudah sangat umum digunakan untuk transfer data. Contoh syntax JSON terlihat seperti 
ini: 



contoh struktur JSON 



1 


{ 






2 




namel : { 




3 




subnamel : 


value. 


4 




subname2 


value 


5 




}, 




6 




name2 : value 




7 


} 







Composer menggunakan format json ini pada file bernama composer . json. Berikut contoh isi composer . json 



18 http://packagist.org 
19 https://github.com/composer/satis 
20 http://j son.org 
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composer.json 



1 { 



2 

3 

4 



require" : { 

"monolog/monolog": "1.0.* 



} 



5 } 



Sebagaimana terlihat pada syntax diatas, pada bagian require kita masukkan nama package yang kita 
butuhkan (monolog/monolog) dan versi yang diinginkan (1.0*). 

Install Package 

Untuk menginstall package dengan composer, pindahkan file composer.json diatas ke sebuah folder. Lalu 
jalankan perintah berikut di dalam folder tersebut: 

1 $ composer install 



e o o 



2. rahmatawaludin@MorphaWorks: ~/Sites/teskumis (zsh) 




composer install 



Perintah diatas akan melakukan instalasi package aplikasi yang kita tulis di bagian require. Setelah dieksekusi 
strutur folder kita akan berubah: 
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Name a Date Modified 



composerjson 


Today, 9:03 PM 


com poser, lock 


Today, 9:04 PM 


▼ D vendor 


Today, 9:11 PM 


autoload. php 


Today, 9:04 PM 


▼ CD composer 


Today, 9:04 PM 


autoload jilassmap.php 


Today, 9:04 PM 


|ij autoload_namespaces.php 


Today, 9:04 PM 


i^i autoload_psr4..php 


Today, 9:04 PM 


i^i autoload_real..php 


Today, 9:04 PM 


(lij ClassLoader.php 


Today, 9:04 PM 


installed .json 


Today, 9:04 PM 


► Cd monolog 


Today, 9:11 PM 



LJ Mac ► Users ► ^ rahmatawaludin ► gj Sites ► Qj teskumis 



composer structure 



• Folder vendor menyimpan package yang dibutuhkan, sebagaimana yang ditulis di bagian require 

• File vendor/autoload . php dapat digunakan untuk mendapatkan fitur autoloading. 

• File composer . lock berfungsi mencatat versi package yang saat ini sedang kita gunakan, jangan 
hapus/edit file ini, karena perintah composer install bergantung pada file ini. 

Update package 

Jika package baru telah ditambah pada bagian require atau versi package yang digunakan dirubah, gunakan 
perintah ini untuk memperbaharui package yang kita gunakan: 

1 $ composer update 

Perintah composer lainnya dapat dilihat dengan perintah : 

1 $ composer --help 

Atau cek di manual composer 21 . 



Instalasi Laravel 

Sebagaimana disampaikan di bagian sebelumnya, Laravel diinstall menggunakan composer. Gunakan perin- 
tah ini untuk membuat project laravel di folder webapp dengan versi laravel 4.2: 



2 1 https:/ / getcomposer.org/doc 
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1 $ composer create-project laravel/laravel=4 . 2 - -prefer-dist webapp 

Jika Anda ingin menginstal versi terbaru dari Laravel, gunakan perintah: 

1 $ composer create-project laravel/laravel --prefer-dist webapp 



ft f) 2 . rahmatawaludin@MorphaWorks: -/Sites (zsh) 



• Sites composer create-project laravel/laravel —prefer-dist webapp 
Installing laravel/laravel (v4.1.18) 

- Installing laravel/laravel (v4.1.18) 

Loading from cache 

Created project in webapp 

Loading composer repositories with package information 
Installing dependencies (including require-dev) 

- Installing symfony/translation (v2.4.2) 

Loading from cache 

- Installing symfony/routing (v2.4.2) 

Loading from cache 

- Installing symfony/process (v2.4.2) 

Loading from cache 

- Installing psr/log (1.0.0) 



install laravel part 1 



0 O O 2. rahmatawaludin@MorphaWorks: -/Sites (zsh) 



to an Elastic Search server) 

monolog/monolog suggests installing ext-amqp (Allow sending log messages to an A 
MQP server (1.0+ required)) 

monolog/monolog suggests installing ext-mongo (Allow sending log messages to a M 
ongoDB server) 

monolog/monolog suggests installing aws/aws-sdk-php (Allow sending log messages 
to AWS services like DynamoDB) 

monolog/monolog suggests installing rollbar/rollbar (Allow sending log messages 
to Rollbar) 

dllwtq/boris suggests installing ext-readline (*) 
dllwtq/boris suggests installing ext-pcntl (*) 

laravel/framework suggests installing doctrine/dbal (Allow renaming columns and 
dropping SQLite columns.) 

Writing lock file 
Generating autoload files 
Generating optimized class loader 

Application key [i40wE326cwt2ogHMxmxBlnx8w2hQF7tX] set successfully. 

• Sites | 



install laravel part 2 



Perintah ini akan menginstall framework laravel dan dependency packagenya. 
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laravel structure 

Jika Anda menggunakan OS *nix, instalasi laravel dapat pula dilakukan dengan menggunakan laravel . phar, 
caranya: 



1. Download Laravel phar 22 

$ wget http : //laravel . com/laravel . phar 

2. Rename file yang telah didownload menjadi laravel 

$ mv laravel. phar laravel 

3. Pindahkan file tersebut ke /usr/local/bin/: 



22 http://laravel.com/laravel.phar 
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$ sudo mv laravel /usr/local/bin/ 

4. Untuk membuat project laravel, jalan perintah : 

$ laravel new webapp 

Konfigurasi 

Setelah Laravel terinstall pastikan folder app/storage dapat diakses oleh web server. Cara sederhananya, 
jalankan perintah ini: 

$ sudo chmod -R 777 app/storage 

Jangan lupa isi juga konfigurasi database Anda (nama database, username, password) di app/con f ig/database . php. 
Tentunya database harus Anda buat sendiri di aplikasi database yang Anda gunakan. 

Untuk memudahkan selama pengembangan, aktifkan mode debug di app/conf ig/app . php ubah isian debug 
menjadi true. 

Menjalankan Web Server 

Web yang dikembangkan dengan Laravel dapat diakses menggunakan PHP builtin web server atau virtual 
host. 

PHP builtin web server 

Jalankan perintah berikut di folder webapp: 

$ php artisan serve 

Setelah Anda menjalankan perintah diatas, aplikasi laravel dapat diakses di http://localhost:8000. Kekurangan 
dari PHP Builtin web server adalah ketika terjadi perubahan pada source code, terkadang server harus di 
restart. 



Virtual Host 

Menggunakan virtual host, aplikasi dapat diakses dengan url seperti http://webapp.site, http://www.webapp.com, 
dan sebagainya walupun masih berada di lokal. Saya sendiri lebih sering menggunakan virtualhost ketika 
mengembangkan web dengan Laravel. Berikut cara membuat virtual host: 
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MAMP 

1. Menggunakan MAMP Pro, buka menu Hosts 

2. Klik tombol [+] 

3. Isi bagian Server name dengan url yang kita inginkan 

4. Isi Disk Location dengan alamat folder public di webapp 

5. Klik Apply 

6. Klik Start untuk merestart server apache. 



flOO 

O 




Server 


Hosts 




localhost 


✓ 




wp-s2s.site 


0 




stc-idms.site 


0 




no-mvc.site 


0 


i 


jobboard.indostart... 


O 




dhc-deral.padjadja... 


0 




dhc-pectro.padjadj... 


0 




dhcmorphaworks... 


0 




dhc-dava.padjadja... 


0 


t 


morphaworks.com 


0 




coddde.com 


0 




gkmagazine.com 


0 


y 


coddder.com 


0 




humancapital.site 


0 


X : 


webapp.site 


0 


- / : 



Setup VirtualHost di MAMP PRO 



XAMPP 

1. Buka file hosts yang ada di alamat C : \WIND0WS\system32\drivers\etc\hosts 

2. Di bagian paling bawah tambahkan alamat IP Address localhost 127.0.0.1 dan nama domain yang dibuat 
misalnya webapp.site 

C:WINDOWS\system32\drivers\etc\hosts 
1 

2 127.0.0.1 webapp.site 

3 



O 



Catatan untuk Windows Terkadang file hosts ini tidak bisa langsung disimpan di tempatnya. 
Solusinya, simpan terlebih dahulu file ini di desktop, lantas replace file aslinya. 
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3. Buka file httpd . conf yang ada di alamat C : \xampp\apache\conf \httpd . conf 

4. Cari bagian Directory, jika aplikasi kita berada di C : /xampp/htdocs/webapp isi seperti ini 

C :\xampp\ap ache\con f\http d. conf 

<Directory "C : /xampp/htdocs/webapp/publ ic"> 

Options Indexes Fol lowSymLinks Includes ExecCGI 
A1 lowOverride All 

4 Order allow, deny 

5 Allow from all 

6 Require all granted 

7 </Directory> 



5. Buka file httpd - vhosts . conf yang ada di alamat C: \xampp\apache\conf \extra 

6. Tambahkan setingan di bawah ini untuk membedakan website yang dipanggil dengan localhost dan 
website yang dipanggil dengan virtual host 

C :\xampp\ap ache\con f\extr a\http d- vhosts . conf 

1 NameVirtualHost *:80 

2 

3 # VirtualHost untuk webapp.site 

4 

5 <VirtualHost *:80> 

6 DocumentRoot C : /xampp/htdocs/webapp/publ ic 
ServerName webapp.site 

8 </VirtualHost> 

9 

10 # Untuk localhost yang biasa 

11 

12 <VirtualHost *:80> 

13 DocumentRoot C : /xampp/htdocs 

14 ServerName localhost 

15 </VirtualHost> 



7. Restart Apache pada XAMPP Control Panel dengan klik tombol stop kemudian klik tombol start. 



Setelah berhasil, Anda dapat mengakses aplikasi di http://webapp.site. 
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eoo 

<r e 



Q Laravel PHP Framework 

Q) webapp.site/ 



X 



= 




Berhasil setup virtualhost 



Ringkasan 

Di Hari 1 ini, saya harap Anda telah memahami bagaimana melakukan setup sebuah project Laravel, poin- 
poin yang telah kita bahas yaitu: 

• Text Editor yang digunakan 

• Penggunaan composer untuk development php modern 

• Instalasi laravel 

• Konfigurasi virtualhost 

Pada hari 2 kita akan mempelajari konsep Routing dan MVC pada Laravel. Semangat! :) 



